home *** CD-ROM | disk | FTP | other *** search
/ Visual Cafe 3 / Visual Cafe 3.ISO / Vcafe / Main.bin / ContainerEvent.java < prev    next >
Text File  |  1998-09-22  |  3KB  |  104 lines
  1. /*
  2.  * @(#)ContainerEvent.java    1.4 98/07/01
  3.  *
  4.  * Copyright 1996-1998 by Sun Microsystems, Inc.,
  5.  * 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
  6.  * All rights reserved.
  7.  * 
  8.  * This software is the confidential and proprietary information
  9.  * of Sun Microsystems, Inc. ("Confidential Information").  You
  10.  * shall not disclose such Confidential Information and shall use
  11.  * it only in accordance with the terms of the license agreement
  12.  * you entered into with Sun.
  13.  */
  14.  
  15. package java.awt.event;
  16.  
  17. import java.awt.AWTEvent;
  18. import java.awt.Container;
  19. import java.awt.Component;
  20.  
  21. /**
  22.  * The class for container-level events.
  23.  * These events are provided for notification purposes ONLY;
  24.  * The AWT will automatically handle container add and remove
  25.  * operations internally.
  26.  *
  27.  * @see ContainerListener
  28.  *
  29.  * @version 1.4 07/01/98
  30.  * @author Tim Prinzing
  31.  * @author Amy Fowler
  32.  */
  33. public class ContainerEvent extends ComponentEvent {
  34.  
  35.     /**
  36.      * Marks the first integer id for the range of container event ids.
  37.      */
  38.     public static final int CONTAINER_FIRST        = 300;
  39.  
  40.     /**
  41.      * Marks the last integer id for the range of container event ids.
  42.      */
  43.     public static final int CONTAINER_LAST        = 301;
  44.  
  45.    /**
  46.      * The component moved event type.
  47.      */
  48.     public static final int COMPONENT_ADDED    = CONTAINER_FIRST;
  49.  
  50.     /**
  51.      * The component resized event type.
  52.      */
  53.     public static final int COMPONENT_REMOVED = 1 + CONTAINER_FIRST;
  54.  
  55.     Component child;
  56.  
  57.     /*
  58.      * JDK 1.1 serialVersionUID 
  59.      */
  60.     private static final long serialVersionUID = -4114942250539772041L;
  61.  
  62.     /**
  63.      * Constructs a ContainerEvent object with the specified source
  64.      * container, type, and child which is being added or removed. 
  65.      * @param source the container where the event originated
  66.      * @id the event type
  67.      * @child the child component
  68.      */
  69.     public ContainerEvent(Component source, int id, Component child) {
  70.         super(source, id);
  71.         this.child = child;
  72.     }
  73.  
  74.     /**
  75.      * Returns the container where this event originated.
  76.      */
  77.     public Container getContainer() {
  78.         return (Container)source; // cast should always be OK, type was checked in constructor
  79.     }
  80.  
  81.     /**
  82.      * Returns the child component that was added or removed in
  83.      * this event.
  84.      */
  85.     public Component getChild() {
  86.         return child;
  87.     }
  88.  
  89.     public String paramString() {
  90.         String typeStr;
  91.         switch(id) {
  92.           case COMPONENT_ADDED:
  93.               typeStr = "COMPONENT_ADDED";
  94.               break;
  95.           case COMPONENT_REMOVED:
  96.               typeStr = "COMPONENT_REMOVED";
  97.               break;
  98.           default:
  99.               typeStr = "unknown type";
  100.         }
  101.         return typeStr + ",child="+child.getName();
  102.     }
  103. }
  104.